XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddLLLLoooocccckkkk - A clipboard function that locks the
clipboard
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/CutPaste.h>
int XmClipboardLock (_d_i_s_p_l_a_y, _w_i_n_d_o_w)
Display * _d_i_s_p_l_a_y;
Window _w_i_n_d_o_w;
(vvvvooooiiiidddd)
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddLLLLoooocccckkkk locks the clipboard from access by another
application until XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddUUUUnnnnlllloooocccckkkk is called. All clipboard
functions lock and unlock the clipboard to prevent
simultaneous access. This function allows the application to
keep the clipboard data from changing between calls to
IIIInnnnqqqquuuuiiiirrrreeee and other clipboard functions. The application does
not need to lock the clipboard between calls to
XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddSSSSttttaaaarrrrttttCCCCooooppppyyyy and XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddEEEEnnnnddddCCCCooooppppyyyy or to
XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddSSSSttttaaaarrrrttttRRRReeeettttrrrriiiieeeevvvveeee and XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddEEEEnnnnddddRRRReeeettttrrrriiiieeeevvvveeee.
If the clipboard is already locked by another application,
XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddLLLLoooocccckkkk returns an error status. Multiple calls to
this function by the same application increase the lock
level.
_d_i_s_p_l_a_y Specifies a pointer to the DDDDiiiissssppppllllaaaayyyy structure that
was returned in a previous call to XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy or
XXXXttttDDDDiiiissssppppllllaaaayyyy.
_w_i_n_d_o_w Specifies the window ID of a widget that relates
the application window to the clipboard. The
widget's window ID can be obtained through
XXXXttttWWWWiiiinnnnddddoooowwww. The same application instance should
pass the same window ID to each of the clipboard
functions that it calls.
RRRREEEETTTTUUUURRRRNNNN
_X_m_C_l_i_p_b_o_a_r_d_S_u_c_c_e_s_s
The function was successful.
_X_m_C_l_i_p_b_o_a_r_d_L_o_c_k_e_d
The function failed because the clipboard was
locked by another application. The application can
continue to call the function again with the same
parameters until the lock goes away. This gives
the application the opportunity to ask if the user
XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddSSSSttttaaaarrrrttttCCCCooooppppyyyy(3), XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddSSSSttttaaaarrrrttttRRRReeeettttrrrriiiieeeevvvveeee(3), and